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FIG. 1 2 



typedef struct EncoderObj \ 

lALG^Obj iolgObj; /* lALG object MUST be first field */ 

Int *workBuf; /* pointer to on-chip scratch mennory */ 

Int *historyBuf; /* previous frome's doto in ext menn */ 
... t 

I EncoderObj ; 



^1201 



Void olgActivote (IALG_Handle hondle) 

EncoderObj *inst = (EncoderObj *)handle; 

/* copy history to beginning of on-chip working buf */ 
menncpy(inst->workingBuf, inst->histBuf. HISTSIZE) ; 

I 

Void encode (IALG_Handle hondle. 

Void *in[] , Void ♦out[] ) 

I 

EncoderObj *inst = (EncoderObj *) handle; 

/* append input buffer to history in on-chip workBuf */ 
nnemcpy (inst->workBuf + HISTSIZE. in HISTSIZE) ; 

/* encode data */ 

/* nnove history to beginning of workbuf for next frame */ 
nnemcpy (inst->workBuf, inst->workingBuf + FRAMESIZE, HISTSIZE) 

I 

Void olgDeactivate ( I ALG_ Handle handle) 



I 



EncoderObj *inst = (EncoderObj *) handle; 

/* save beginning of on-chip workBuf to history */ 
memcpy (inst->histBuf, inst->workingBuf. HISTSIZE) ; 



M202 
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FIG. 1 4 



typedef struct EncoderStotus | 

Bool voicePresent; /* voice in current fronne? */ 
... , 

I EncoderStotus; 

typedef enunn jEncoderGetStotus, „\ EncoderCnnd; 

Void oigControl (lALG.Hondie handle, 

IALG_Cnnd cnnd. IALG_Status *status) 



EncoderStotus *sptr = (EncoderStotus *)status; 

switch ((EncoderCnnd)cnnd) | 
cose EncoderGetStotus: 
sptr->voicePresent = ...; 

case EncoderSetMIPS: 



FIG. 1 5 

typedef struct EncoderObj \ 
IALG_Obj iolgObj 
Int *workBuf; 
Int workBufLen; 



A lALG object MUST be first field */ 



\ EncoderObj; 

Int algFree(IALG_Handle handle, IALG_MemRec nnennTab[] ) 



EncoderObj *inst = (EncoderObj *)handle; 
algAlloc(NULL, memTob) ; 



/* get default values first */ 



memTob 
memTob 
return(2)'; 



1] .size = inst->workBufLen * sizeof(Int) ; 
1] .base = (Void *)'^st->workBuf; 



I 

Int olgAlloc(IALG_Porams *paroms. IALG_MemRec memTab[] ) 



memTob 


0' 


.size = sizeof (EncoderObj) ; 


memTob 


"0' 


.alignment = 1; 


memTob 


0' 


.type = lALG.PERSIST; 


memTob 


;o; 


.space = iALG_ EXTERNAL; 


memTob 


1' 


.size = 80; 


memTob 


'1' 


.olignment = 1; 


memTob 


'1' 


.type = lALG.PERSIST; 


memTob 


'1' 


.spoce = lALG.DARAM; 


return (2) 


1 



/* 10ms @ 8KHz */ 
/* no alignment */ 

/* dual-access on-chip */ 
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FIG. 1 6 



typedef struct EncoderObj | 
lALG.Obj iolgObj 
Int workBuf; 
Int workBufLen; 

\ EncoderObj ; 



/* lALG object MUST be first field */ 
/* pointer to on-chip scrotch nnemory 
/* workBuf length (in words) */ 



Int algInit(IALG_Handle hondle, 

IALG_MennRec nnemTab[]. IALG_Handle p, IALG_Paranns *olgPoranns) 



I 



EncoderObj *inst = (EncoderObj *)handle; 
EncoderPcrams *poranns = (EncoderPoranns *)olgParams; 



if (poronns == NULL) | 

poroms = &ENCODERATTRS; 



/* use default parameters «/ 



inst->workBuf = memTob[l] .base; 
inst->workBufLen = poronns- >franneDuration * 8; 



return (lALG.EOK) ; 



FIG. 1 7 

typedef struct EncoderObj \ 

IALG_Obj iolgObj /* lALG object MUST be first field */ 
int workBuf; /♦ pointer to on-chip scratch mennory */ 
Int workBufLen; /* workBuf leingth (in words) */ 
... , 

\ EncoderObj ; 

algMoved(IALG_Handle handle, 

IALG_Paranns *olgPorams, IALG_MemRec naennTob[] ) 

1701<{j EncoderObj *inst = (EncoderObj *)handle; 

inst->workBuf = nnemTob[l] .base; 
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^define NUMBUF 3 /* max number of my memory requests */ 

^ / Cr, 1 S extern lALG_Fxns *subAlg; /* sub-olgorithm used by this olg */ 



1801 



I 



Int algNumAlloc(Void) 



return (NUMBUF + subAlg->algNumAlloc()) ; 



Int algAlloc(const IALG_ParQms *p, struct IALG_Fxns **pFxns, 
IALG_MemRec memTob) 



Int n; 

/* initiolize my memory requests */ 

/* initialize sub-algorithm's requests */ 
n = subAlg->algAlloc(..., memTob) ; 
return (n + NUMBUF) ; 



FIG. 1 9 



/*— - 

jifdefine 
Idefine 
Idefine 
Idefine 
Idefine 
Idefine 
Idefine 
Idefine 

/ 



TYPES AND CONSTANTS 



IRTC.ENTER 

IRTC_CLASS1 

IRTC_CtASS2 

IRTC_CIASS3 

IRTC_CLASS4 

1RTC_CLASS5 

IRTC_CLASS6 

IRTC_CLASS7 



0 
1 
2 
3 
4 
5 
6 
7 



-*/ 



190K 



^ = = = = ==^= IRTC_Hondle = ==== = = = 

* Handle to nnodule's trace instance object 

V 

typedef struct IRTC_Obj * I RTC_ Handle; 
/* 

* === =====IRTC_Masl< = = ===== = 

V 

typedef LgUns IRTC_Mask ; 

/* 

* ========IRTC_Fxns ==== === = 

V 

typedef struct IRTC_Fxns \ 

Void *implementationId; 

Void f+rtcBind) (LOG_Obj *log) ; 

IRTC_Mask (*rtcGet) (IRTC_Handle) ; 

Void (*rtcSet) (IRTC_Handle. lRTC_Mask mask) ; 

I lRTC_Fxns: 



2007- 



2001 



2002 
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WITH MEMORY INTERFACE 



COMBINE ALGORITHM MODULES 
WITH A FRAMEWORK 



LOAD SOFTWARE SYSTEM 
ON HARDWARE PLATFORM 



EXECUTE THE 
SOFTWARE SYSTEM 



■2006 
mallocO 




2009- 




free) 
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PROCESSING METHODS 
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FIG. 23A 
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client.c 


INCLUDES 


fir.h 


► 


^include <fir.h> 

r 

FIR_apply() ; 

1 


typedef struct FIR_Obj ♦FlR_Hondle; 

extern void FIR_init() ; 

extern void FIR_exit() ; 

extern FIR_Handle FIR_create() ; 



•301 



FIG. 3 



302 



fir_apply.asm 



.globol FIR_apply 
FlR_apply: 



fir_creote.c 



FIR_Hondle FIR_create() |. 



FIG. 4 



FIR 

FIR_Config FIR; 
FIR_init() ; 
FIR_exit() ; 
FIR.creoteQ ;- 



^403 



J 



FIR 



FIR_creote() 



ix-402 
CREATES 




READ-ONLY 
COE FFICIENT ARR AY 

I 

FILTER INPUT 
HI STORY BUFFE R 
I I I I I i 



FIG. 6 
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CALLS 
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<] :( ALGORITHM 



602 
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50K 



void FIR_init (void) 
( 

void FIR_exit (void) 

I 



FIG. 5 



505^ 



typedef FIR_Params | /* FIR_Obj creotion parameters */ 



int frameLen 
int *coeff ; 
I FiR_Paranns ; 



/♦ input/output frame length */ 
/* pointer to filter coefficients */ 



FiR_Porams FIR_PARAMS = | 64. NULL | ; /* defoult parameters •/ 

typedef struct FIR_Obj | /* FIR_Obj definition */ 
int hist [16] ; /* previous input value */ 

int frameLen ; /* input frame length */ 

int *coeff ; 

I FIR_Obj : 



FIR_Handle FIR_create (FlR_Obj ♦fir, const FiR_Porams *porams) 



I 



502^ 



if (fir != NULL) | 

if (poroms == NULL) | /♦ use defaults if paroms is NULL */ 
porams = &FIR_PARAMS ; 

i 

fir->fromeLen = paronns->frameLen ; 
fir->coeff = params->coeff ; 
^ memset(fir->hist, 0, sizeof (fir->hist)) ; 

return (fir) ; 



503-8 I 



void FIR_delete (FIR_Handle fir) 



void FIR_apply (FlR_Handle fir, int in[] , int out[] ) 
int i ; 

504*11 ^* ^''^^"^ ^sinq coefficients fir->coeff and 
history fir->hist */ 
for (i = 0 ; i < fir->frameLen; i++) | 

out [i] = filter(in[i], fir->coeff, fir->hist) ; 

I ^ 
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FIG. 7B 



* ==== ==== IALG_Obj == ===== = 

* Algorithm instance object definition 
* 

* All XDAIS clgorithnn instonce objects *nnust* have this structure as their first elennent. 

* However, they do not need to initialize it; initialization of this sub-structure is done by 

* the "framework". 

V 



typedef struct IALG_Obj } 

struct IALG_Fxns *fxns; }r'705 
I iALG_Obj; 



■I 



♦ ======== lALG.Hondie ===== === 

* Handle to on algorithm instance object 



V 

typedef struct IALG_Obj ♦IALG_Hondle; 



707 



* ==== ==== lALG_Paroms == ====== 

* Algorithm instonce erection porometers 

* All XDAIS algorithm parameter structures *must* have a this as their first element. 
*/ 



typedef struct IALG_Params | 

Int size; /* number of MAUs (i.e. the 'sizeof') the structure */ 
I IALG_Params; 



703 



* ==== = = = = IALG_Status === ===== 

* Pointer to olgorithm specific status structure 

* All XDAIS algorithm status structures *must* hove this as their first element. 

V 



typedef struct lALG_Stotus | 

Int size; /* number of MAUs (i.e. the 'sizeof') the structure */ }}^704 
I lALG.Stotus; 



* ==== = = = = |ALG_Cmd == = ==== = 

* Algorithm specific command. This commend is used in conjunction with IALG_Status to 

* get and set algorithm specific ottributes via the olgControl method. 
♦/ 

typedef unsigned int iALG_Cmd; 
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FIG. 9 



client 0 



FIR_Params stdParams; 
FIR„TLPorams tiParams; 

stdPoroms = FIR_PARAMS; 
stdParams.coeff = 
fxns->algAlloc(&stdParams. ...) ; 

tiParams = F1R_TI_PARAMS; 
tiParams.coeff = 
fxns->algAlloc(&tiParams, ...) ; 



A 
A 
A 



A 
A 
A 



initiolize oil fields to defoults */ 
initiolize selected porometers */ 
poss parameters to algorithm */ 

initialize all fields to defaults */ 
initialize selected porometers */ 
pass parameters to olgorithm */ 



I 



FIR_TLalgAlloc(iALG_Paroms *clientPorams, ...) 

FIR^TLPoroms params = FIR.TLPARAMS; 

/* client passes in parameters, use them to override defaults */ 
if (clientParoms != NULL) \ 

memcpy(&porams, clientParoms, clientParams->size) ; 



/* use poroms os the complete set of porometers */ 



Void FIR.opply (FIR_Handle olg, Int *in[]. Int *out[] ) 

/♦do opp specific initialization of scratch memory */ 
if (alg->fxns->ialg.algActivate != NULL) | 
olg->fxns->ialg_algActivate(alg) ; 

/* filter date */ 
alg->fxns->filter(alg, in, out) ; 

/* do opp specific store of persistent data */ 
if (alg->fxns->ialg.algDeQctivate != NULL) \ 
alg->fxns">ialg.algDeactivate(alg) ; 



FIG. 1 1 
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FIG. 1 0 

#define MAXMEMRECS 16 

typedef struct ALG_Obj | 

IALG_Fxns fxns; /* algorithm functions */ 

I ALG.Obj; 

IALG_Handle ALG_creote (IALG_Fxns *fxns, IALG_Parcnns *params) 

IALG_MennRec mennTob [MAXMEMRECS] ; 
IALG_ Handle clg = NULL; 
int n; 

if (fxns->algNumAlloc () <= MAXMEMRECS) | 
n = fxns->olgAlloc(poronns, nnennTcb) ; 
if (allocMemory(nnemTab, n)) | 

clg = (IALG_Hondle)mennTab[0] .bose; 
1001^ olg->fxns = fxns ; 

if (fxns->alglnit(alg, nnennTab, poroms) != iALG_EOK) | 
fxns->algFree(alg, memTob) ; 
freeMemory(memTab, n) ; 
olg = NULL; 

I 



I 



return (alg) ; 



Void ALG_delete (lALG.Hondle clg) 

lALG.MemRec memTob [MAXMEMRECS] ; 
1002^ Int n; 

n = alg->fxns->algFree(alg, memTob) ; 
freeMemory(memTob, n) ; 



